Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

wasm-json-toolkit

Package Overview
Dependencies
Maintainers
1
Versions
16
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

wasm-json-toolkit

this convertes wasm binaries to json and json to wasm binaries

  • 0.3.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
16
decreased by-36%
Maintainers
1
Weekly downloads
 
Created
Source

SYNOPSIS

NPM Package Build Status Coverage Status

js-standard-style

A small toolkit for converting wasm binaries into json and back.

INSTALL

npm install wasm-json-toolkit

USAGE

const fs = require('fs')
const wasm2json = require('wasm-json-toolkit').wasm2json

const wasm = fs.readFileSync('./test.wasm')
const json = wasm2json(wasm)

console.log(JSON.stringify(json, null, 2))

CLI

Install -g global for cli usage.

wasm2json [FILE] given a file containing a wasm module produces a json representation
json2wasm [FILE] given a file containing a json representation produces a wasm module

API

wasm2json

converts a wasm binary into a json representation

Parameters

  • Buffer - The Webassembly Binary
  • filter - Set containing the name of sections to parse. If no filter is given all sections will be parsed

Returns Object

json2wasm

converts a json representation to a wasm binary

Parameters

  • Object

Returns Buffer

text2json

converts text to json. The only text accepted is a simple list of opcode name and immediates

Parameters

  • String

Examples

const codeStr = `
i64.const 1
i64.const 2
i64.add
`
const json = text2json(codeStr)

Returns Object

iterator

iterator.js:12-58

The Module Iterator allows for iteration over a webassembly module's sections. A section is wrapped in a section class. A section class instance allows you append entries to a given section

Examples

const it = new Iterator(wasm)
for (const section of it) {
  console.log(section.type)
  const json = section.toJSON()
}

wasm

iterator.js:26-32

if the orignal wasm module was modified then this will return the modified wasm module

iterator

iterator.js:38-52

Iterates through the module's sections return {Iterator.

}

Section

iterator.js:64-110

The section class is always internal created by the Module class. And return through the Module's iternator

toJSON

iterator.js:83-85

Parses the section and return the JSON repesentation of it returns {Object}

appendEntries

iterator.js:92-109

Appends an array of entries to this section. NOTE: this will modify the parent wasm module.

Parameters

exammple json output

wast

(module
  (func $addTwo (param i32 i32) (result i32)
    (i32.add
      (get_local 0)
      (get_local 1)))
  (export "addTwo" (func $addTwo)))

wasm

0x010661646454776f00000a09010700200020016a0b

json

[
  {
    "name": "preramble",
    "magic": [0,97,115,109],
    "version": [13,0,0,0]
  },
  {
    "name": "type",
    "entries": [
      {
        "form": "func",
        "params": ["i32","i32"],
        "return_type": "i32"
      }
    ]
  },
  {
    "name": "function",
    "entries": [0]
  },
  {
    "name": "export",
    "entries": [
      {
        "field_str": "addTwo",
        "kind": "Function",
        "index": 0
      }
    ]
  },
  {
    "name": "code",
    "entries": [
      {
        "locals": [],
        "code": [
          {
            "name": "get_local",
            "immediaties": "0"
          },
          {
            "name": "get_local",
            "immediaties": "1"
          },
          {
            "return_type": "i32",
            "name": "add"
          },
          {
            "name": "end"
          }
        ]
      }
    ]
  }
]

LICENSE

MPL-2.0

Keywords

FAQs

Package last updated on 24 Apr 2018

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc